home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / util1 / dosmax21.zip / SHELLMAX.DOC < prev    next >
Text File  |  1993-06-01  |  11KB  |  287 lines
  1.  
  2. ================================================================================
  3.        SHELLMAX.COM :  Ver. 2.1, Copyright (1992,93) by Philip B. Gardner
  4. ================================================================================
  5.  
  6.   SHELLMAX.COM is a utility which loads the primary shell high from the
  7.   SHELL= line in your CONFIG.SYS.
  8.  
  9.   Support is provided for:
  10.  
  11.         * Loading the primary SHELL into high memory
  12.         * Creating a primary SHELL stub in low memory
  13.           (improves compatability with some configurations)
  14.  
  15. ================================================================================
  16.  
  17. (Requirements)::
  18.  
  19.         * Requires MS-DOS Version 3.10 or better
  20.  
  21. ================================================================================
  22.  
  23. (Installation)::
  24.  
  25.         (CONFIG.SYS)::
  26.  
  27.         Installation of SHELLMAX.COM requires modifying the contents of
  28.         your CONFIG.SYS file.
  29.  
  30.         SHELL=SHELLMAX.COM [options] COMMAND.COM /P
  31.  
  32.         Insert SHELLMAX.COM in your SHELL= line of your CONFIG.SYS.
  33.         SHELLMAX.  
  34.  
  35. (Safety)::
  36.  
  37.         When installing SHELLMAX, it is best if you copy SHELLMAX.COM and
  38.         COMMAND.COM (the primary shell), to the root directory of your boot
  39.         drive.  If SHELLMAX fails to function properly with the parameters
  40.         in your SHELL= command line, it will issue a series of error messages,
  41.         and then try and load COMMAND.COM from the root directory.  This will
  42.         give you a chance to edit the CONFIG.SYS and correct the problem.
  43.         You should exercise caution and have a boot floppy available.
  44.  
  45.         SHELLMAX is compatible with full SHELL= command line specifications.
  46.         In the following example, neither SHELLMAX.COM or COMMAND.COM is
  47.         required in the root directory after installation is successful, as
  48.         indicated by no error or warning messages.
  49.  
  50.         SHELL=C:\BOOT\SHELLMAX.COM /R- C:\DOS\COMMAND.COM C:\DOS /E:512 /P
  51.  
  52.         All switch options and possible messages for SHELLMAX are detailed
  53.         below:
  54.  
  55. ================================================================================
  56.  
  57. (Compatibility)::
  58.  
  59.     (4DOS)::
  60.  
  61.         If you are using Version 4.x 4DOS from J.P. Software, you should
  62.         add the path to 4DOS.COM to the 4DOS command line.
  63.  
  64.         SHELL=SHELLMAX.COM C:\4DOS\4DOS.COM C:\4DOS /p
  65.  
  66.         If this parameter is not added, 4DOS may not set the environment
  67.         variable "COMSPEC=" properly.
  68.  
  69.     (DOS 3.x & 4.x)::
  70.  
  71.         Some versions of DOS incorrectly truncate the command line to 35
  72.         characters for the SHELL= statement in the CONFIG.SYS or fail to
  73.         pass a command line at all if the line is over 35 characters.
  74.         This bug is circumvented by a special algorithum in SHELLMAX.  If
  75.         SHELLMAX does not work for you, and you suspect that this is the
  76.         problem, please contact me for assistance.
  77.  
  78. ================================================================================
  79.  
  80. (Syntax)::
  81.  
  82.         The only thing to remember about syntax for the command line is
  83.         that just about anything works.  What this means is that you
  84.         should be able to type in the options on the command line the
  85.         way they make sense to you.
  86.  
  87.         To illustrate this point, the following command line example
  88.         is mutated several different ways.
  89.  
  90.         SHELL=SHELLMAX.COM /R- /P+ /S+ C:\COMMAND.COM C:\ /P
  91.         SHELL=SHELLMAX.COM -R- -P+ -S+ C:\COMMAND.COM C:\ /P
  92.         SHELL=SHELLMAX.COM /R-/P+/S+ C:\COMMAND.COM C:\ /P
  93.         SHELL=SHELLMAX.COM -R--P+-S+ C:\COMMAND.COM C:\ /P
  94.  
  95.         ... and so on.
  96.  
  97.         SHELLMAX 2.0 and above adds optional full word syntax.  The new
  98.         syntax looks like this:
  99.  
  100.         SHELL=SHELLMAX.COM /REPORT:- /PAUSE:+ /FAKESTUB:+ C:\COMMAND.COM C:\ /P
  101.         SHELL=SHELLMAX.COM -REPORT:- -PAUSE:+ -FAKESTUB:+ C:\COMMAND.COM C:\ /P
  102.         SHELL=SHELLMAX.COM /REPORT:-/PAUSE:+/FAKESTUB:+ C:\COMMAND.COM C:\ /P
  103.         SHELL=SHELLMAX.COM -REPORT:--PAUSE:+-FAKESTUB:+ C:\COMMAND.COM C:\ /P
  104.  
  105.         Obviously when using full words, it is easier to keep the words
  106.         separated so that is clear to read.  The optional [:] is used
  107.         for toggle switches (i.e. REPORT:+).  These optional delimiters
  108.         can also be used with the single letter switches.  Exact spelling
  109.         is required because the single letter interface is still intact.
  110.  
  111. (Switch Options)::
  112.  
  113.         The following list of switch options is organized by:
  114.  
  115.           - Control of SHELLMAX Reports (/R:/P:/N:)
  116.           - Control the Configuration of a Fake Low Memory Stub (/S:)
  117.           - Response file for SHELLMAX (@)
  118.  
  119.     (Control of SHELLMAX Reports)::
  120.  
  121.         (REPORT)::      R[+ or -]        (toggle:  default +)
  122.  
  123.         Use /R- or /REPORT:- to disable the report after you are
  124.         satisfied with the configuration of STOPMAX.SYS
  125.  
  126.         (PAUSE)::       P[+ or -]        (toggle:  default +)
  127.  
  128.         Use /P- or /PAUSE:- to disable the pause after the report as
  129.         long as there are no errors or warnings.
  130.  
  131.         (NOPAUSE)::     N[+ or -]        (toggle:  default -)
  132.  
  133.         Use /N+ or /NOPAUSE:+ to never pause after the report, even if
  134.         there are errors.  This switch can be used if your configuration
  135.         generates a warning or error message which you choose to ignore.
  136.  
  137.     (Control the Configuration of a Fake Low Memory Stub)
  138.  
  139.         (FAKESTUB)::    S[+ or -]        (toggle:  default -)
  140.  
  141.         If you use SHELLMAX to load the shell high, then some programs
  142.         (environment editors and some networks), are confused that no
  143.         portion of the primary shell is is low memory.  Use /S+ or 
  144.         /FAKESTUB:+ to tell SHELLMAX to create a fake stub, which looks
  145.         like the primary shell, in low memory.  This stub tracks changes
  146.         to the Master Environment segment pointer by monitoring the real
  147.         stub high (each "get exit code of sub-program"  INT 21h, 4Dh).
  148.         The stub size is 256 bytes, so if you use 4DOS, and find that
  149.         you need the low stub, it is better to just let 4DOS do it and
  150.         not use SHELLMAX.
  151.  
  152.   (Response file for SHELLMAX)::
  153.  
  154.         Parameters for SHELLMAX may be read from a response file by using the
  155.         @pathname syntax:
  156.         
  157.         SHELLMAX.COM @RESPONSE.FIL C:\COMMAND.COM C:\ /E:512 /P
  158.  
  159.         Notice that the path to the SHELL is cannot be in the response file.
  160.  
  161.         Response files may be commented by using a ";","#",or "*" character
  162.         before the comment.
  163.  
  164.         *  everything in square brackets "[]" is optional
  165.  
  166. (CONFIG.SYS Line)::
  167.  
  168.         SHELL=SHELLMAX.COM [/R-/P+/N+/S+] COMMAND.COM /P
  169.  
  170.         default:  /R+/P-/N-/S-
  171.  
  172.         *  Report status messages
  173.         *  Don't Pause after report
  174.         *  Pause on errors or warnings
  175.         *  Don't Fake stub low
  176.  
  177. ================================================================================
  178.  
  179. (Report Format)::
  180.  
  181.     SHELLMAX.COM (8086):  Ver. 2.1, Copyright (1992,93) by Philip B. Gardner
  182.                  ERROR :  (Error Messages)
  183.                WARNING :  (Warning Messages)
  184.                 ADVICE :  (Advisory Messages)
  185.                        :  (Report Messages)
  186.                        :  (Allocation Status)
  187.                  PAUSE :  Press any key to continue... 
  188.  
  189. ================================================================================
  190.  
  191. (Error Messages)::
  192.  
  193.         MS-DOS version 3.10 or above is required
  194.         Bad or missing program specification
  195.         Use SHELLMAX.COM only as CONFIG.SYS SHELL=
  196.     Not enough memory to execute 
  197.         Fatal Error, program halted
  198.  
  199. ================================================================================
  200.  
  201. (Warning Messages)::
  202.  
  203.         Unknown option in command line
  204.         Unknown option on line #0000
  205.         Extra characters on command line
  206.         Missing or invalid option file XXXXXXXX.XXX
  207.         Line length overflow at line #0000
  208.         Unable to load high, loading low
  209.  
  210. ================================================================================
  211.  
  212. (Advisory Messages)::
  213.  
  214. ================================================================================
  215.  
  216. (Report Messages)::
  217.  
  218.         Processing option file XXXXXXXX.XXX
  219.     Effection section is [XXXXXXXX]
  220.  
  221. ================================================================================
  222.  
  223. (Allocation Status)::
  224.  
  225.         SHELL    loaded at 0000
  226.         Not enough Hi Memory for SHELL
  227.         STUB     faked at 0000
  228.  
  229. ================================================================================
  230.  
  231. (Changes)::
  232.  
  233.     (Version 1.7)::
  234.  
  235.     (1)  Found a workaround to 4DOS 4.x initialization hang.  4DOS now will
  236.          load properly.  One caveat, add path to 4DOS to the 4DOS command
  237.          line or 4DOS will not find 4DOS.INI or set the COMSPEC variable
  238.          correctly.
  239.  
  240.     (2)  Corrected problem with DOS 3.x and DOS 4.x when the standard handles
  241.          were getting closed by mistake.
  242.  
  243.     (3)  When COMMAND.COM path argument was a different drive then the boot
  244.          drive, COMMAND.COM was looking for the AUTOEXEC.BAT on the drive
  245.          of the argument instead of the boot drive.  Fixed so COMMAND.COM
  246.          processes the AUTOEXEC.BAT from the boot drive.
  247.  
  248.     (4)  Version bumped to match DOSMAX
  249.  
  250.     (Version 1.8)::
  251.  
  252.     (1)  Added /S+ option to create a fake primary shell stub in low memory.
  253.          This works around environment editor and network compatability
  254.          problems.
  255.  
  256.     (2)  Improved error recovery with the goal of trying every way of at
  257.          least loading some shell in the event the algorithum of SHELLMAX
  258.          encounters multiple errors.
  259.  
  260.     (Version 1.9)::
  261.  
  262.     (1)  Reorganized code to enable an overlay method of module selection
  263.          to automate processor selection and split up .SYS and .EXE modules
  264.          to reduce the initialization memory to minimum.
  265.  
  266.     (2)  SHELLMAX now automatically detects the processor type and chooses
  267.          separate code modules if appropriate.  The 186 processor require-
  268.          ment of previous versions is no longer applicable.
  269.  
  270.     (3)  Added optional full word syntax to argument parser.  The old style
  271.          single letter switch interface is still intact.  The switch lists
  272.          now show the optional word with the switch.
  273.  
  274.     (Version 2.0)::
  275.  
  276.     (1)  Completely rewritten.  Added feature to edit command line if
  277.          the SHELL is bad or missing.
  278.  
  279.     (2)  Added option response file input with @filename.opt syntax
  280.  
  281.     (Version 2.1)::
  282.  
  283.     (1)  Fixed problem with finding DOS 6.0 CONFIG variable for machines
  284.          whose bios'es don't intialize memory properly.
  285.  
  286. ================================================================================
  287.